home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / os2 / srefv12i.zip / changes.doc < prev    next >
Text File  |  1997-04-24  |  35KB  |  743 lines
  1. 5 Mar 1997.
  2.  
  3. This document contains a history of changes to SRE-FILTER, starting
  4. from version 1.2d.  Older changes (from version 1.11 to 1.2d)
  5. are in CHANGES0.DOC (CHANGES0.DOC can be found at
  6. http://rpbcam.econ.ag.gov/srefilter/changes0.doc)
  7.  
  8. Please note that as of this writing the SRE-Filter is at version 1.2i
  9. (sub version .305).  Currently ,there is no fix-pack needed for version 1.2i.
  10. However, there will almost certainly be changes (and bug fixes) in the near
  11. future.  When they become available, they will be distributed in
  12. FIXES12I.ZIP -- keep an occasional eye on the SRE-Filter home page
  13. (http://rpbcam.econ.ag.gov/srefilter).
  14.  
  15. You may also want to examine the documentation files:
  16.    A "frequently asked questions" file: SREFILTR.FAQ,
  17.    An outline of how SRE-Filter works: OUTLINE.HTM
  18.    The SRE-Filter manual: SREFILTR.HTM
  19.    A detailed description of initialization parameters: INITFILT.DOC
  20.  
  21.  
  22.                  ------------------------------------
  23.                      Changes from ver 1.2d to 1.2e:
  24.  
  25. HTACCESS support added:
  26.    Addition of support for directory-specific access controls (and
  27.    redirection) using HTACCESS files (using code adapated from the
  28.    GOHTTP filter, courtesy of D. Meyer).
  29.    For further details, see the description of the HTACCESS_FILE and
  30.    DO_HTACCESS variables in INITIFLT.DOC
  31.  
  32.    One fringe benefit of HTACCESS support is that the SHOWDIR dynamic
  33.    directory list processor can now be used with SRE-Filter -- see
  34.    SHOWDIR.DOC for details.
  35.  
  36. NOTIFY method of redirection added:
  37.    Addition of a !NOTIFY method of redirection (client is informed of the
  38.    move, but is not actually redirected).
  39.  
  40. Best matching is used (instead of first matches):
  41.    When searching access controls, virtual directories, aliases, and the
  42.    various other .IN, .CNT, and .CTL files: SRE-filter will now use a "best
  43.    match" criteria, rather then a first match criteria, when choosing
  44.    between wildcard matches (exact matches still have priority).
  45.  
  46. User defined MIME types:
  47.    You can now define your own MIME media types using the MEDIATYP.RXX file.
  48.    Furthermore, you can define your own "SHTML" (server side include
  49.    permitted HTML files) extensions by modifying the SSI_EXTENSIONS variable.
  50.  
  51.  
  52.                     --------------------------------------
  53.                  Changes from 1.2e to 1.2f  (up to 24 Sept 1996)
  54.  
  55.  
  56. Configurator improvements:
  57.    A number of changes were made to the "Initialization Parameters" portion
  58.    of the configurator (in addition to earlier changes to the "parameter
  59.    files section). The most important change is that you can now use the
  60.    configurator to modify "host specific" parameters en masse.
  61.  
  62.    Almost all initialization parameters can be host specific.
  63.    The naming convention has been standardized (NAME.HOST_NICKNAME or
  64.    NAME.n.HOST_NICKNAME). Note that the OWNERS, PUBLIC_URLS, INHOUSEIPS, and
  65.    UNALLOWEDIPS parameters must be host-specific (non host-specific values
  66.    will NOT be used as defaults for these four parameters).
  67.  
  68.    The configurator can now be used to view and modify HTACCESS files.
  69.  
  70. Enhancements to file upload capabilities:
  71.    The GET_URL and PUT_FILE "file upload" methods are no longer limited to
  72.    the UPLOAD_DIR directory.  The client can now specify a directory (using
  73.    a URL-like syntax, i.e.; DIR1/foo.bar) of the UPLOAD_DIR.  Furthermore,
  74.    the "subdirectory" portion can map to a virtual directory -- for example,
  75.    DIR1/ may map to D:\NOTWWW\OURDIR\.
  76.    As a security feature, uploads to  "virtual directory" require
  77.    that this virtual directory (i.e.; DIR1/) have a PUT permission assigned
  78.    to it (using the ACCESS_FILE).
  79. Addition of a simple load balancing feature:
  80.    You can implement a simple form of load balancing by changing
  81.    a few parameters in the SREFILTR.80 file.  See the discussion of the
  82.    LOADTHRESHOLD variable in INITFILT.DOC for details.
  83.  
  84. Improvments to the FIX_EXPIRE parameter:
  85.    The FIX_EXPIRE parameter (for suppressing "immediate expiration")
  86.    now applies to GETAFILE, DOSEARCH, and CGI-BIN requests (as well as
  87.    documents cnotaining server side includes).
  88.  
  89. Changes to the post-filter capability:
  90.    You can now call a series of Post-filters (instead of just one).
  91.    The Post-filters are now passed the name of the fully qualified file
  92.    used in the request (either a document name, or the name of the CGI
  93.    script or external REXX procedure used in a server side processing
  94.    request).
  95.  
  96.    The "used file" is now passed to the client.  This may be the
  97.    name of the file transfered (such as an HTML or GIF file),
  98.    the name of the CGI-BIN script executed, or the name of the
  99.    external REXX procedure executed).
  100.  
  101.    POSTRCRD.80, A simple "client information recorder" post-filter,
  102.    is not packaged with SRE-Filter. POSTFILT.80 is now just a simple
  103.    example, with POSTMAIL.80 now containing the "e-mail alert" procedure.
  104.  
  105. Changes to public_urls:
  106.  
  107.    When determining which of several wildcard matches to PUBLIC_URLS should
  108.    be used, a "best match" is used rather then a "first match".
  109.    On multiple-host servers, only PUBLIC_URLS specifically listed for a
  110.    (defined) host are used (that is, the non host-specific PUBLC_URLS are
  111.    NOT used as defaults).
  112.  
  113.    There is now a more forgiving method of responding to "literal"
  114.    PUBLIC_URLS that point to aliases. Before, requests that matched
  115.    these "improper" literal public_urls resulted in "no such document"
  116.    responses.  Now, SRE-Filter will ignore the "literal", and treat
  117.    the request like a normal PUBLIC_URL (that is, alias matching
  118.    will be attempted).
  119.  
  120. Logon bug fix:
  121.    Repaired a bug that, under unusual circumstances, allowed a client
  122.    to logon by using a blank username and password.
  123.  
  124.  
  125. -------------------------------------------------------
  126. Changes from  ver 1.2f to ver 1.2g.
  127.  
  128. !DIRECTORY option added to AUTO_NAME.
  129.    !DIRECTORY and !DIRECTORY* are now synonyms for !CREATE and !CREATE*.
  130.  
  131. Fixed uninformative "not found document" message:
  132.    When using the !CREATE "auto name" option, if the requested directory did not
  133.    exist, a too-simple "Unavailable" message was returned.  Now, the standard
  134.    "document not found" message will be returned.
  135.  
  136. Not found response can now point to a file:
  137.    You can now return a customized document (rather then a simple text string)
  138.    whenever a request for a  non-existent resource occurs.  See the
  139.    the discussion of the NOT_FOUND_RESPONSE variable (in INITFILT.DOC)
  140.    for details.
  141.  
  142. Timefmt NSCA HTTPD directive brought up to spec:
  143.     The timefmt NCSA HTTPD "server side include" directive is now fully
  144.     supported by SRE-Filter -- all dates in the NCSA HTTPD style server
  145.     side includes will now follow the rules set in timefmt directives
  146.     (with a default of '%c').   For details on the timefmt directive,
  147.     see TIMEFMT.DOC.  Note that the "native" SRE-Filter time and date
  148.     server side includes are not effected by timefmt (basically,
  149.     a %c equivalent is used; i.e.; 13:01:33 27 August 1988).
  150.  
  151. DNS_CHECK bug repaired
  152.     DNS_CHECK failed to work.  It has now been fixed.
  153.  
  154. Restructuring of code:
  155.     A minor restructuring of code to shrink the size of the filter (but
  156.     expand macrospace) should help speed things up (a bit) under load.
  157.  
  158. Best match improvement:
  159.     Best match will now consider the "length of the string after the *"
  160.     when comparing "best matches" that are otherwise equivalent (see
  161.     INITFILT.DOC for details).
  162.  
  163. Message box facility improved:
  164.     The simple message box facility (MESSAGE, ASKMESSBOX, and VIEWMESS)
  165.     has been upgraded.  Of greater interest, a new  "multi-
  166.     threaded forum" facility has been added.  This uses REXX procedures
  167.     and server side including HTML documents, in conjunction with
  168.     SRE-Filter message boxes, to implement a basic multi-threaded
  169.     forum using a "news reader" type interface. See FORUM.DOC for details.
  170.  
  171.     Note that MESSBOX specific privileges (possibly wildcarded)
  172.     are now required to access message boxes (either through the
  173.     MESSAGE or FORUM).
  174.  
  175. A "list server" like facility added:
  176.     Complementing the improved message boxes and the FORUM facility,
  177.     READMAIL and MAILLIST, two "list server" like facilities, have been
  178.     added. READMAIL (and MAILLIST) will read e-mail messages stored in an
  179.     inbox (say, as written by SENDMAIL), and place the contents of these
  180.     messages into a SRE-Filter messagebox OR rebroadcast the
  181.     message to a list of users.  See READMAIL.DOC for details.
  182.  
  183. Fixed an occasional bug in the INTERPRET and SELECT keyphrases:
  184.     A problem when setting INTERPRET.RESULTS or SELECT.RESULT has
  185.     been fixed.  In addition, you can now return results to
  186.     the SELECT keyphrase by including RETURN 1 or RETURN 0 in your
  187.     "REXX code block" (rather then setting the value of SELECT.RESULT).
  188.     Similarly, use of QUEUE statements, in addition to setting the
  189.     value of INTERPRET.RESULTS, is supported for the INTERPRET keyphrase.
  190.  
  191. An example of how to set up a simple, 3-tiered site:
  192.     See INITFILT.DOC for a description of how to efficiently setup a
  193.     3-tiered site: with directories et al that provide unmonitored public
  194.     access, monitored public access, and controlled access.
  195.  
  196. Fixed a bug with the HOSTS. variables:
  197.     Requests directly to a numeric IP address, rather then a name,
  198.     were mishandled when a HOST: request header was present.  This has
  199.     been fixed.
  200.  
  201. Add COUNTS_FILE and HITS_FILE server side include options:
  202.     COUNTS_FILE and HITS_FILE are equivalent to the COUNTS and HITS
  203.     options of the REPLACE ssi keyphrase.  The difference is that
  204.     the fully qualified file name is used, rather then the request string
  205.     (the URL).
  206.  
  207. RECORD_OPTION can now "record by file":
  208.      You can tell SRE-Filter to record all requests by file name,
  209.      rather then by URL (this is the RECORD_ALL_FILE equivalent to
  210.      COUNTS_FILE and HITS_FILE) -- see the description of RECORD_OPTION
  211.      in INITFILT.DOC for details
  212.  
  213. A bug when "aliasing" CGI-BIN scripts has been fixed:
  214.     The use of aliases to redirect CGI-BIN requests to scripts, in
  215.     directories other then CGI_BIN_DIR, malfunctioned when the
  216.     request was of the form CGI-BIN/ASCRIPT?wow (where ASCRIPT
  217.     was an alias to some directory).
  218.  
  219. A syntax for indicating the directory of a CGI-BIN script:
  220.     When the CGI-BIN/ sub-string apears after some subdirectory information
  221.     (for example  DADSTUFF/SCRIPTS1/CGI-BIN/ascript?anargumemt),
  222.     SRE-Filter will use that "pre CGI-BIN/"  information as a pointer to
  223.     the directory containing the script.
  224.     Note that this may be under the CGI_BIN_DIR, or may be a virtual
  225.     directory (i.e.; D:\GOSERVE\CGI-BIN\DADSTUFF\SCRIPTS1\)
  226.  
  227. NO_SSP permissions were not applied to CGI-BIN scripts:
  228.     CGI-BIN requests took place, even if a NO_SSP permission applied.
  229.     This has been fixed (this is now an important feature, given
  230.     the "non-spec" virtual directory method mentioned above).
  231.  
  232. Adding the "username" to the privilege list:
  233.      SRE-Filter will now add the users "logon name" to her
  234.      privilege list (this can be suppressed). This can be useful,
  235.      when combined with URL-specific access controls, as a means
  236.      of providing individualized access.
  237.  
  238. PUBLIC_PRIVS added to privilege list of PUBLIC_URLS:
  239.  
  240. The RECORD_ALL_FILE can now be cached:
  241.     To cut down on the number of disk writes, the RECORD_ALL_FILE
  242.     is now cached.  To modify, or turn this caching on, set the
  243.     RECORD_CACHE_LINES variable in SREFILTR.80
  244.  
  245. A "just read" documents list can now be used to suppress hit augmenting:
  246.     To cut down on false hits (i.e.; from people "backing up" to a
  247.     document), SRE-Filter can maintain a  "suppress recent hits list".
  248.     To turn this feature on, see the HIT_CACHE_LEN variable in
  249.     INITFILT.DOC.
  250.  
  251. Minor modification to range retrieval:
  252.      Range retrieval now understands the If-modified: and Umless-modified:
  253.      request headers.  Note that the If-Invalid: and If-valid: headers
  254.      are ignored.
  255.  
  256. Changes to the USETABL2.RXX "interpretable" file:
  257.      The list of "table capable" and "table incapable" browsers has been greatly
  258.      expanded. Also, a bug that could crash GoServe has been fixed
  259.      (if the user-agent was unknown, an EXIT command resulted, which crashed GoServe).
  260.  
  261. Changes to PUBLIC_URL processing:
  262.      * If a literal public_url was specified using an "exact name" that
  263.        contained a * wildcard, the appropriate file match was not performed,
  264.        and a "not found" message was returned.  This has been fixed.
  265.      * The PUBLIC_PRIVS are now used as the privilege list for
  266.        request for PUBLIC_URLS.  Note that this can be useful when
  267.        using a PUBLIC_URL to invoke  the FORUM or MESSAGE facilities
  268.        (i.e.; include a MESSBOX:PUBFORUM in your PUBLIC_PRIVS list).
  269.      * PUBLIC_URLS may have a  NORECORD attribute (in addition to
  270.        the LITERAL and LITERAL_NORECORD attribute).  T
  271.      * The "exact names" in literal PUBLIC_URLS with "exact names" can
  272.        now contain a * wildcard character (SRE-Filter will make the
  273.        appropriate substituttion.
  274.  
  275.  
  276. ---------------------------------------------
  277. Fixes to ver 1.2g.
  278.  
  279. FIXES.ZIP contains the latest changes. Note that the latest version
  280. of SREFV12.ZIP will also contain these changes -- you should obtain
  281. FIXES.ZIP only if you have an earlier version of SRE-Filter ver 1.2g.
  282.  
  283. To use FIXES.ZIP:
  284.  1) Stop GoServe
  285.  2) UNZIP FIXES.ZIP.  If asked, overwrite all files.
  286.  3) Run FREEUP.CMD from an OS/2 prompt.  This will flush all
  287.     SRE-Filter routines from macrospace (if you are using other programs
  288.     that use macrospace, you may need to restart them).
  289.  4) Restart GoServe.
  290. No other changes are required.
  291.  
  292. 10/28/96
  293.    *  Post-filter routines now are given the value of the "referer" request
  294.       header.  See POSTRCRD.80 for an example of how this is used.
  295.  
  296. 10/30/96
  297.    *  The "PASSWORD" field in SRE-Filter message boxes was inadvertently
  298.        set when no explicit password was given. FORUM would then accept
  299.        a blank password as a legitimate match.  This has been fixed.
  300.  
  301. 10/31/96
  302.    *   A HIT_SUPPRESS_OWNERS variable, when set to 1, will instruct
  303.        SRE-Filter NOT to record requests from OWNERS.
  304.        For details, see the description of the HIT_SUPPRESS_OWNERS
  305.        variable in INITFILT.DOC.
  306.    *    You can now "chain" pre-filters.  For details, see the descripiton of
  307.         PREFILTER_NAME in INITFILT.DOC.
  308.  
  309. 11/01/96
  310.    *    The GETAFILE facility was been upgraded:
  311.            A  suppress TABLE border option has been added
  312.            The SHOWDATE=YES option of GETAFILE now shows dates using
  313.            15 Nov 1995 format (if you want to display dates using a
  314.            11/15/95 format, use SHOWDATE=YES_SHORT).
  315.            See SREFILTR.HTM for details.
  316.  
  317. 11/03/96
  318.  
  319.    *    The INTERPRET FILE keyphrase can now include arguments, which
  320.         will be available to the "interpreted" REXX file. See
  321.         SREFILTR.HTM for details.
  322.    *    The "resource privileges" list can now contain two types
  323.         of privileges -- ANY_ONE and MUST_HAVE; where ANY_ONE are
  324.         "or" conditions, and MUST_HAVE are "and" conditions.
  325.         See SREFILTR.HTM for details.
  326.    *    A dynamic (and short lived)  privilege can be assigned to
  327.         clients (using their IP address).  This can be used to restrict
  328.         access to files to those going through "proper" procedures.
  329.         Furthermore, creation of these dynamic privileges is easily
  330.         accomplished by invoking the ADDPRIV.RXX add-on in an INTERPRET FILE
  331.         keyphrase. See ADDPRIV.DOC for details.
  332.     *    A LOGON_LIMIT number of "logons" can be enforced per client per minute.
  333.     *    If  LOGON_FAIL_FILE is set, a custom written  "logon-failure" response
  334.          file can be sent instead of a plain "401 Unauthorized" response.
  335.          See the discussion of the LOGON_FAIL_FILE variable in INITFILT.DOC
  336.          for details.
  337.  
  338. 11/07/96
  339.     *    If the client does not have "URL-specific" access, an ACCESS_FAIL_FILE
  340.          can be sent.
  341.     *    A "access failure file" field has been added to the ACCESS_FILE.
  342.          If present, it overrides the value of ACCESS_FAIL_FILE.
  343.          See the discussion of the ACCESS_FAIL_FILE variable in INITFILT.DOC
  344.          for details.
  345.     *    The SRE-Filter configurator has been modified to recognize thie
  346.          "access failure file" field in the ACCESS_FILE.
  347.  
  348. 11/08/96
  349.     *    The OWNERS variable was not being recognized.
  350.          The HIT_OWNER_SUPPRESS variable was not being acted on.
  351.          Both of these bugs have been fixed. Note that in all likelihood,
  352.          these bugs were introduced around Nov. 3.
  353.  
  354. 11/10/96
  355.     *    A NO_INTERPRET_CODE parameter can now be set; it instructs SRE-Filter
  356.          to suppress SELECT and INTERPRET CODE server-side-include keyphrases.
  357.          In addition, an equivalent "NO_CODE" permission can be set on a
  358.          "URL-specific" basis.  Note that this is a subset of NO_PROCESSING
  359.          and the NO_SSP permission -- it provides some protection against
  360.          ill-mannered users, without quashing all server-side includes and
  361.          processing.
  362.     *    The ACCESS_FAIL_FILE and LOGON_FAIL_FILE are now set in INITFILT.80
  363.          (rather then in SREFILTER.80).
  364.  
  365. 11/12/96
  366.     *    You can tell SRE-Filter to save "request specific" information
  367.          to a temporary file. This information can be used by external
  368.          procedures, AND by post-filter actions. See the description of
  369.          the SAVE_STATE variable (in INITFILT.DOC) for details.
  370.     *    To support the above, SRE-Filter now passes the "thread-id"
  371.          of the request to the post-filter processor.
  372.  
  373.  
  374. 11/14/96
  375.     *    A "web page counter", COUNTER.RXX, is now included. COUNTER.RXX has
  376.          a number of options, including the ability to save information on
  377.          each request.  See COUNTER.DOC for details.
  378.     *    The SENDFILE facility can use COUNTER.RXX (rather then the simpler
  379.          default). See SREFILTR.HTM for details.
  380.  
  381.  
  382. 11/16/96
  383.     *   When using the LOGON_FAIL_FILE, Netscape would not display the response
  384.         (due to faulty response code).  This has been fixed.
  385.     *   The error message when attempting to SENDFILE a non-existent file
  386.         was uninformative. This has been fixed.  SENDFILE will also
  387.         note (if COUNTER= is used) failed attempts.
  388.  
  389. 11/17/96
  390.     *   Modified the various *CFG.CMD files (the configurator procedures)
  391.         to permit remote access by clients with SUPERUSER privileges.
  392.     *   The "own name" privilege was being added to the client privilege
  393.         list, even when ADD_USER_NAME='NO'. This has been fixed.
  394.  
  395. 11/19/96
  396.     *   Minor modifications to FILTINST.CMD.
  397.     *   Created SREF_WRITE_STATE -- the complement to SREF_READ_STATE
  398.         (used for writing to the "thread specific" cache)
  399.     *   If SAVE_STATE=1, the SENDFILE facility will write the bytes sent
  400.         and the bytes in the file to a SENDFILE_STATUS variable in
  401.         the "thread specific" cache
  402.     *   CGI-BIN calls are given two additional (SRE-Filter specific) variables:
  403.         CALLER_THREAD (useful if you want to use SREF_WRITE_STATE) and
  404.         SCRIPT_DIR  (the directory the of CGI-BIN script being executed).
  405.         In addition, TEST-CGI.CMD has been modified to display these
  406.         "environment variables".
  407.  
  408. 11/21/96
  409.     *   The OWNER_SUPPRESS feature of COUNTER.RXX did not work, when called
  410.         as a procedure.  This has been fixed.
  411.     *   The "#config sizefmt=xxx" server side include directive
  412.         was not spec.  This has been fixed: fractions are not used
  413.         when sizefmt=abbrev, and commas are inserted when sizefmt=bytes.
  414.     *   COUNTER.RXX can now generate simple "odomoeter" style graphical
  415.         counters, when called as an in-line image (it uses Don Meyer's
  416.         XCOUNT.CMD code).
  417.  
  418. 11/23/96
  419.     *  On GET method requests that invoke an external procedure to
  420.        perform "server side processing": the LIST variable (consisting
  421.        of items following a ? in the request string) is url-decoded
  422.        url-decoded -- the documentation (SREFILTR.HTM) had claimed that
  423.        it was not!
  424.        Note that in some cases it's best to use the URI argument, which
  425.        will contain the original request string.
  426.  
  427. 11/27/96
  428.     *   The RESPONSE_FILE option of the MESSAGE facility did not work.
  429.         This has been fixed.
  430.     *   A simple means of "limiting" the scope of virtual directories
  431.         has been added.  See the "sample" VIRTUAL.IN file for details.
  432.     *   A few options have been added to GETAFILE, including a "standard"
  433.         mode (where you specify just the subdirectory) that yields
  434.         a standard tabular display of icon, name, date and size.
  435.         See GETAFILE.HTM for details.
  436. 12/01/96
  437.     *   The installation procedure has been moderately reworked. It now
  438.         gives you the opportunity to set a few of the more commonly
  439.         used parameters.
  440.     *   A  bug that rendered GETAFILE useless, introduced sometime between
  441.         11/27 and 12/01,  was repaired.
  442.     *   The various .CMD files now give coherent error messages if accidentally
  443.         run from the command line (rather then called as external procedures
  444.         by SRE-Filter).
  445.  
  446. 12/09/96
  447.     *   The AUTO_HEADER would occasionally add a second : to http-equiv
  448.         generated response headers.  This has been fixed.
  449.  
  450. ----------------
  451. On 12/31/96, a new version of SRE-Filter was released (SREFV12H.ZIP).
  452. This incorporates all the above changes, plus the following. Note
  453. that since this is a new version, there is no FIXES file for it
  454. (yet!)
  455.  
  456. Changes from 1.2g to 1.2h
  457.  
  458.     *   User specific "web" subdirectories of the HOME_DIR can now be
  459.         specified by including a $ in the HOME_DIR parameter.
  460.  
  461.     *   The HOME_DIR replacment for ~ could not be used with AUTO_NAME
  462.         construction.  This has been fixed (HOME_DIR replacement now
  463.         occurs before AUTO_NAME construction).
  464.  
  465.     *   The FORUM, READMAIL and MAILLIST facilities are no longer
  466.         packaged with SRE-Filter.  Instead, they are available as
  467.         add ons.
  468.  
  469.     *   A web based BBS add-on is now available for SRE-Filter.
  470.  
  471.     *   The   MAILLIST add-on can now be instructed to forward unused mail
  472.         (mail NOT to one of the listed "forums") to an alternative
  473.         mail box  directory.  Furthermore, a special .UML file can be created
  474.         for use by UltiMail.
  475.  
  476.     *   !DIR, a new "directory lister" has been added to SRE-Filter.
  477.         The !DIR facility largely replaces the GETAFILE external
  478.         procedure; it is used when a !CREATE option appears in the
  479.         AUTO_NAME variable.
  480.             To control the format and content of the directory listings
  481.         created by !DIR, two new variables have been added to
  482.         INITFILT.80: DIR_OPTIONS and DIR_EXCLUSION
  483.             Furthermore, !DIR will cache it's output, and use the cache
  484.         when appropriate.  This can substantially improve performance,
  485.         especially when you are using "automatic descriptions".
  486.             For more details on the !DIR facility, pless see DIR.DOC.
  487.  
  488.     *    GETAFILE is now available as an add-on.
  489.          GETAFILE has a few new features, including:
  490.              * the ability to use "one line per file" description
  491.                files (these are more standard then the "block delimited"
  492.                files used by earlier versions of GETAFILE).
  493.              * the ability to automatically generate a description for
  494.                HTML, Text, and .ZIP files
  495.              * the ability to "expand" .ZIP files, and to extract files from
  496.                .ZIP files
  497.          Note: the !DIR built-in facility also has the first two of these
  498.                features (but NOT the .ZIP file expansion capability)
  499.  
  500.      *   Several new special "directives" have been added:
  501.            !SENDAS_MIMETYPE_SUBTYPE -- forces server to use a particular
  502.                                         mime-type/subtype
  503.            !DELSEND  -- Sends, and then deletes, files from the
  504.                         TEMPFILE_DIR directory.
  505.            !FORCE -- Used in LOGON_FAIL_FILE s to "force" a logon.
  506.                      It also can be used to "suppress the SSI-CACHE",
  507.  
  508.      *   The SRE-Filter configurator has been substantially re-done.
  509.          There is now a "simple" mode configurator, as well as the
  510.          older "intermediate" mode configurator. As part of this process,
  511.          the FILTINST.* files have been renamed. If you use the
  512.          defaults to install SRE-Filter (ver 1.2h), you can invoke
  513.          the configurator by pointing your browser at
  514.          http://your.server/CONFIGURE
  515.  
  516.      *  The CACHED_FILES parameter has been dropped.
  517.  
  518.      *  A seperate "thread" has been added to handle the "SSI-Cache".
  519.         The SSI-Cache is used to cahce html documents which contain server
  520.         side includes.
  521.         SSICACHE.HTM contains a description of how "SSI-caching" works,
  522.         and how you can configure it.
  523.  
  524.       * If the HEADER.1 parameter begins with a <BODY>, it will replace the
  525.         first <BODY> element (rather the follow it).
  526.  
  527.      *  Self-recursive (hence infinite) server-side includes are now trapped.
  528.  
  529.      *  Several new documentation files have been added, including GUIDE.HTM --
  530.         a guide to the features of SRE-Filter (it complements SUMMARY.HTM).
  531.  
  532. 1/14/97 -- Version 1.2g.113
  533.  
  534.      * Several small bugs in the SSI-caching algorithim were fixed (?OPTIONS
  535.        #FLASTMOD, and #FSIZE were not being replaced)
  536.  
  537.      * The CONFIG2.CMD "intermediate configurator" returned a "Sorry"
  538.        message if the client did not have SUPERUSER privileges. It will now
  539.        challenge the client for username/password.
  540.  
  541.       * STATUS.CMD will now report on the number of !DIR and SSI-Cache
  542.         files. It can also be instructed to "clear the !DIR cache".
  543.         STATUS.HTM has also been upgraded -- it now has
  544.         several other "configuration and status" options
  545.  
  546.      * A "install code only" option has been added to the INSTALL program
  547.        (this should be useful to upgraders).
  548.  
  549. 1/18/97 -- Version 1.2g.118
  550.  
  551.      * Modified the access_fail_File feature to facilitate "dynamic
  552.        privileges" (a value of 1, and -1, now have special meanings)
  553.  
  554.      * A few new add-ons are  available (_COMMAND and SREFANIM).
  555.  
  556.      * A new special command, !AUTHORIZE, has been added. When issued,
  557.        SRE-Filter will send back an "authorization" request (this is
  558.        intended for administrator use).
  559.  
  560.      * The WRITE_TO_FILE option of the MESSAGE facility did not understand
  561.        y or yes (lower case).  This has been fixed.
  562.  
  563.      * A REDIR option is now available for the NOEXT_TYPE parameter -- it is
  564.        similar to DIR, but will redirect the client before attempting to
  565.        resolve the  directory specific name.
  566.  
  567. 1/23/97. Version 1.2h.123
  568.  
  569.      * A MULTI_SEND option has been added to the DIR_OPTIONS parameter.
  570.        It instructs !DIR to send "status messages" to Connection:Keep-Alive
  571.        capable browsers.
  572.  
  573.      * SREF_MULTI_SEND, a new procedure to facilitate multiple part documents,
  574.        has been added to the SRE-Filter macrospace library.
  575.  
  576.      * The _COMMAND add-on would crash under Merlin when input was expected.
  577.        This has been fixed.
  578.  
  579.  
  580. 1/25/97. Version 1.2h.1.25
  581.      *  Fixed several bugs:
  582.           i) SENDFILE did not include a content-length header: netscape
  583.              would show NO status information during downloads.  This
  584.              has been fixed.
  585.          ii) PUBLIC_URLS that began with a / did not match otherwise
  586.              equal request strings. Now, leading / and \ are stripped.
  587.        * The documenation was edited again (and not for the last time)
  588.  
  589. Ver 1.2h.125 of SRE-Filter is considered to be a "general release" version.
  590. Changes after this can be achieved by obtaining the FIXES12H.ZIP file on
  591. the SRE-Filter home page. Note that if you are downloading SREFV12H.ZIP
  592. (or it's components), you do NOT need to obtain FIXES12H.ZIP.
  593.  
  594. 2/09/97.  Version 1.2h.209
  595.      * Fixed several bugs:
  596.         i) The !DIR facility did not properly deal with files that had
  597.            no extension.
  598.        ii) The AUTO_DESCRIBE=0 and DESCRIBE=0 "request string" options of
  599.            the !DIR facility did not work.
  600.       iii) The DIRINFO.RXX "interpretable" file returned incorrect results.
  601.        iv) The #CONFIG NCSA SSI directive was being improperly cached.
  602.  
  603.     * Fixed a bug caused by an incompatability between the Toronto Virtual
  604.       File System and REXX.  This bug caused incorrect output from the
  605.       !DIR facility (and add-ons that used the SYSFILETREE procedure). Work
  606.       arounds for this have been put into place.
  607.  
  608. ----------------
  609. On 5 March 1997, a new version of SRE-Filter was released (SREFV12I.ZIP).
  610. This was soon followed by releases on 3/07 and 3/10. As of this
  611. writing, the 10 March release (version 1.2.i.310) is the "general
  612. availability" release.
  613.  
  614. Note there is no FIXES file, yet... though you could think of the .310
  615. version as fixes for the two earlier versions!
  616.  
  617. Changes from 1.2h to 1.2i (other then various bug fixes, mostly dealing
  618. with proper detection of post-filter suppression)
  619.  
  620.  * STATUS.HTM has been upgraded (it now contains a number of configuration
  621.    links).
  622.  
  623.  * New options added  to the ACCESS_FAIL_FILE parameter
  624.  
  625.  * A REDIR option is now available for the NOEXT_TYPE parameter --
  626.    it cause a redirection back to xxx/yyy/.
  627.  
  628.  * A MULTI_SEND option has been added to the DIR_OPTIONS parameter.
  629.    It instructs !DIR to send "status messages" to Connection:Keep-Alive
  630.    capable browsers.
  631.  
  632.  * SREF_MULTI_SEND, a new procedure to facilitate multiple part documents,
  633.        has been added to the SRE-Filter macrospace library.
  634.  
  635.  * A "change the configurator background colors" facility is now built into
  636.    the configurator
  637.  
  638.  * A special environment variable, SREF_PRIVSET, has been added to the CGI-BIN
  639.    enviornment variables.  Similarly, PRIVSET is now added to the SAVE_STATE
  640.    "thread specific cache"
  641.  
  642.  * SRE-Filter will now record requests in a common-log audit file (as
  643.    well as record browsers and referers in seperate log files).
  644.  
  645.  * Several new add-ons are now available (including an updated search
  646.    engine facility).
  647.  
  648.  * The documentation was put through a heavy edit. Besides a lot of
  649.    new and revised verbiage, be aware that some of the terminology
  650.    has changed. In particular:
  651.      the term "URL-specific" has been changed to "SEL-specific", and
  652.           "requested URL" has been changed to  "request selector"
  653.    (it still leaves something to be desired, but it's more technically
  654.    accurate)
  655.  
  656.  * The SREFQUIK variant was improved: a few bugs fixed, a new option to
  657.    control "post-filtering", and much better documentation (SREFQUIK.DOC).
  658.  
  659.  * You can now "suppress hits" from supersers, as well as owners
  660.    (see the description of HIT_SUPERUSER_SUPPRESS in INITFILT.DOC).
  661.  
  662.  * A new set of  "advanced options" can be enabled on a "SEL-specific"
  663.    basis. These include pre-file-transfer execution of an external
  664.    REXX procedure, customization of the response headers, and
  665.    selective suppression of server side includes (see ADV_OPTS.DOC for
  666.    details). 
  667.  
  668.  * A few of the less frequently used SRE-Filter facilities (such as PUT
  669.    request processing) were not properly interpreting the "homename" variable.
  670.    This has been fixed.
  671.  
  672.  * The #INCLUDE and INCLUDE ssi-keyphrases are now slightly different ---
  673.    INCLUDE will check for "recursive includes", #INCLUDE will not. Since
  674.    a very simple recursive-file checking algorithim is used, INCLUDE will
  675.    only let you include a file ONCE -- if you want to include a file 
  676.    twice (say, a button bar list at the top and bottom of your document), use
  677.    #INCLUDE.
  678.  
  679.  
  680.  
  681. 3/18/97
  682.  
  683.   * The "username" feature of the "nologs" option for suppressing
  684.     common-log audit file entries was not working (it has been fixed).
  685.  
  686.   * The !DIR directive now understands the * wildcard character.
  687.  
  688. 3/21/97
  689.   * The intermediate configurator "over-refreshed" (when a back button
  690.     was pushed).  This has been fixed.
  691.  
  692. 3/22/97
  693.   * A new option, NOREFERERS, has been added to the SREFLOGS.INI file
  694.   * An advanced Status facility (NUSTATUS) is now available.
  695.  
  696. 3/25/97  --- Version 1.2i.325 released.
  697.  
  698.   * Several bugs relating to the use of INHOUSEIPS. were fixed. In addition, you
  699.      can now use * in IP names with INHOUSEIPS. parameters.
  700.   * CERN imagemaps are now supported (as well as NCSA imagemaps).  See
  701.      the NCSA_ISMAP and CERN_ISMAP parameters (in INITFILT.DOC) for details.
  702.  
  703. 4/01/97  --- Version 1.2i.401 released
  704.   *  Documents containing SELECT ssi-keyphrases will now be cached.
  705.   *  FREEUP procedure has been simplified and fixed.
  706.  
  707. 4/02/97
  708.    *  COUNTER.RXX failed when used as an "INTERPRET FILE" keyphrase. This has been
  709.       fixed.
  710.  
  711. 4/03/97 
  712.    *  SRE-Filter would crash when a very long request string was recieved,
  713.       common-log audting was on, and VERBOSE>0.  This has been fixed.
  714.  
  715. 4/06/97 -- Version 1.2i.497a release  (note change in version numbering scheme)
  716.    *  Minor improvements to the RECORD_ALL_FILE caching algorithim.
  717.    *  Added a "save total bytes and bytes sent" option to COUNTER.RXX.  Also
  718.       a minor edit of COUNTER.DOC.
  719.    *  Minor changes to SREFMON.CMD (corrected some low probability bugs).
  720.    *  Minor changes to GETAFILE add-on.
  721.    *  Due to minor format misspecification, common-log files were not being read by
  722.       several log-audit tools (such as GETSTATS and ANALOG).  This has been fixed.
  723.  
  724. 4/15/97  
  725.     * Minor changes to COUNTER.RXX: fixed some small bugs. More importantly,
  726.       add a DURATION option (for reporting number of hits in last "duration" days).
  727.     * When a !SENDAS_x_y requeset string (without anything after the "y") was recieved, 
  728.       SRE-Filter would CRASH.  This has been fixed.
  729.  
  730. 4/17/97:  Version 1.2i.497b release
  731.     *  When host specific parameters were commented out, they were not being removed from
  732.        the SRE-Filter environment.  This has been fixed.
  733.     *  You can now redirect a DEFAULT, by entering the full URL (this is mostly useful
  734.         if you have multiple hosts).
  735.  
  736. 4/22/97
  737.     * The intermediate configurator failed to save the DO_HTACCESS variable. This has
  738.        been fixed.
  739.     *  A "shut down and restart GoServe/SRE-Filter remotely" add-on is now available.
  740.  
  741.  
  742. --- End of document.
  743.